package com.studyweb.mapper;

import com.studyweb.pojo.entity.UserAchievement;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * 用户成就Mapper接口
 * 
 * @author StudyWeb Team
 * @since 1.0.0
 */
@Mapper
public interface UserAchievementMapper {
    
    /**
     * 根据ID查询用户成就
     * 
     * @param id 用户成就ID
     * @return 用户成就信息
     */
    UserAchievement selectById(@Param("id") Long id);
    
    /**
     * 根据用户ID查询用户成就
     * 
     * @param userId 用户ID
     * @return 用户成就列表
     */
    List<UserAchievement> selectByUserId(@Param("userId") Long userId);
    
    /**
     * 根据用户ID和成就ID查询用户成就
     * 
     * @param userId 用户ID
     * @param achievementId 成就ID
     * @return 用户成就信息
     */
    UserAchievement selectByUserIdAndAchievementId(@Param("userId") Long userId, @Param("achievementId") Long achievementId);
    
    /**
     * 根据用户ID和成就类别查询用户成就
     * 
     * @param userId 用户ID
     * @param category 成就类别
     * @return 用户成就列表
     */
    List<UserAchievement> selectByUserIdAndCategory(@Param("userId") Long userId, @Param("category") String category);
    
    /**
     * 插入用户成就
     * 
     * @param userAchievement 用户成就信息
     * @return 影响行数
     */
    int insert(UserAchievement userAchievement);
    
    /**
     * 更新用户成就
     * 
     * @param userAchievement 用户成就信息
     * @return 影响行数
     */
    int update(UserAchievement userAchievement);
    
    /**
     * 删除用户成就
     * 
     * @param id 用户成就ID
     * @return 影响行数
     */
    int deleteById(@Param("id") Long id);
    
    /**
     * 删除用户的所有成就
     * 
     * @param userId 用户ID
     * @return 影响行数
     */
    int deleteByUserId(@Param("userId") Long userId);
    
    /**
     * 查询用户获得的成就数量
     * 
     * @param userId 用户ID
     * @return 成就数量
     */
    int countByUserId(@Param("userId") Long userId);
    
    /**
     * 查询用户在特定类别获得的成就数量
     * 
     * @param userId 用户ID
     * @param category 成就类别
     * @return 成就数量
     */
    int countByUserIdAndCategory(@Param("userId") Long userId, @Param("category") String category);
}